home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / utils / graphic / viewers / general / amiga / 3ddraw10 / 3ddraw.doc next >
Encoding:
Text File  |  1992-03-27  |  7.4 KB  |  174 lines
  1.  
  2.  
  3.  
  4.  
  5.        ***************************************************************
  6.        *                                                             *
  7.        *            THE AMAZING 3-D OBJECT EDITOR/VIEWER             *
  8.        *               *--==++++++++++++++++++++==--*                *
  9.        *                                                             *
  10.        *                                                             *
  11.        *                                                             *
  12.        *                Hacked out by MATT R. JOHNSON                *
  13.        *                                                             *
  14.        *                                                             *
  15.        *                                                             *
  16.        *                      //                                     *
  17.        *                     //                                      *
  18.        *                 \\ //  ONLY with AMIGA !                    *
  19.        *                  \X/                                        *
  20.        *                                                             *
  21.        ***************************************************************
  22.  
  23.  
  24.        USER MANUAL
  25.        ===========
  26.  
  27.             The program will open in a null state, you must select
  28.        an option from the menu to begin.  It would make the most
  29.        sense to choose the 'ADD' option to begin with, as you pretty
  30.        much can't do anything until you have something to work with :)
  31.        The 'ADD' option is for adding vertices to the current
  32.        object, and the 'CLOSE' and 'DELETE' options remain open to
  33.        you in the 'ADD' option also.  During the Vertex Operation
  34.        options (EDIT, ADD, CLOSE, DELETE), the vertex you are
  35.        currently working on is always highlighted in red, except
  36.        during the 'CLOSE' operation (explained later).  To add a new
  37.        vertex, attached to the current vertex (highlighted in red),
  38.        you simply place the mouse pointer where you
  39.        want the new vertex in the X/Y plane, and click the left
  40.        mouse button once.  The new vertex will appear ATTACHED TO
  41.        THE CURRENT VERTEX (Highlighted in red).  Pressing the space
  42.        bar will cycle the current vertex through all the existing
  43.        vertices - you may do this until the current vertex is the
  44.        one you want to attach the new vertex onto the shape from.
  45.  
  46.             Once you have one or more vertices, you can edit their
  47.        positions in 3-D space using the 'EDIT' option.  In 'EDIT',
  48.        the 'DELETE' and 'CLOSE' options are again left open for you.
  49.        To move a vertex, simply cycle the current vertex
  50.        (highlighted in red) until it is the one you want to move.
  51.        Click the left mouse button anywhere on the screen, hold it
  52.        in, and drag until the vertex is where you want it in the X/Y
  53.        plane.  The vertex will move animately in the same manner
  54.        that the mouse moves - by relative x/y coordinates.
  55.        To move the vertex in the Z direction (in or out),
  56.        simply click on one of the green gadgets in the upper left
  57.        corner of the window - left for further away, right for
  58.        closer.
  59.  
  60.  
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.  
  75.             The 'CLOSE' option is for closing off a surface of the
  76.        shape by connecting two already-existing vertices.  You must
  77.        first cycle the current vertex (highlighted in red) to one of
  78.        the vertices you wish to connect, and then select the 'CLOSE'
  79.        option - a checkmark will then appear by the menu option
  80.        'CLOSE'.  A Vertex will then be highlighted in blue, while the
  81.        previous one remains highlighted in red.  Cycle the blue
  82.        vertex (again, by pressing the space bar) until it is the
  83.        OTHER vertex, the one you wish to connect to the red one.
  84.        Then simply select the 'CLOSE' option again, the checkmark by
  85.        it will disappear.  To abort the 'CLOSE', simply cycle the
  86.        blue vertex until is is on the same vertex as the red one,
  87.        and select 'CLOSE'.
  88.  
  89.             The 'DELETE' option is for deleting a vertex.  Simply
  90.        select the 'DELETE' option - a checkmark will appear by its
  91.        menu item.  Then cycle the current vertex (highlighted in
  92.        red) until it is the one you want deleted, and select delete
  93.        again - the checkmark (and the vertex) will disappear.
  94.  
  95.             Once your object is entered to your satisfaction, you
  96.        can view it, and be able to move, scale, and rotate it
  97.        freely.  If the 'ADD' option or the 'EDIT' option is active,
  98.        as indicated by a checkmark by their menu items, you must
  99.        select the checked item again to turn it off and enter the
  100.        transformation mode.  In this mode, you will see the 'MOVE',
  101.        'SCALE', and 'ROTATE' options become available in the menu.
  102.        The currently working transformation is displayed in the
  103.        small window at the top of the screen.  To select any
  104.        dimensions that you may want transformations in (such as the
  105.        X dimension...) simple press that dimension's letter.  To
  106.        change direction of rotation or scale, press + for clockwise/bigger,
  107.        and '-' for counterclockwise/smaller.  Moving is accomplished
  108.        for the shape the same way it was for a vertex in the 'EDIT'
  109.        option.  Rotation and scaling are done from a point where the
  110.        mouse is clicked, in the manner indicated in the small window at
  111.        the top of the display window.
  112.  
  113.             This program is Copyrighted ⌐ 1992, Matt R. Johnson.  Any
  114.        may freely distribute the program as long as this DOC file is
  115.        distributed, unchanged, with it.  Any harm done by this program
  116.        or the use of it is solely the responsibility of the party using
  117.        the program, Mr. Johnson takes no such responsibility.
  118.  
  119.             In the developement of the program, I used the GNU C compiler,
  120.        CYGNUS-Ed Pro, and PowerWindows V1.2.  Any questions about the
  121.        program and/or tools used in its development sent to me will be
  122.        replied to to the best of my ability, and source for the program
  123.        may be available upon request, if a fairly decent reason is given :)
  124.  
  125.  
  126.  
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.        FUTURE VERSIONS
  140.        ---------------
  141.  
  142.             It is my intention to do some further development of this
  143.        project.  There is one important bug, I couldn't quite get the
  144.        memory managemnt to be really consistent, thus the program fails
  145.        to return some memory to the system.  A reboot is sometimes
  146.        necessary after running the program to set all the memory strait.
  147.        Along with fixing this bug, there are a few things I want to add.
  148.        Here are some of the things to look forward to :
  149.  
  150.               * Multiple objects, attached to their own windows
  151.               * Better memory management
  152.               * Optimized animation routines and data representation,
  153.                 for faster animation
  154.               * More convenient user interface, using dead keys to full
  155.                 advantage
  156.               * Online help, using the 'help' dead key
  157.               * No distortion due to pixel dimension in non-interlaced
  158.                 screen
  159.               * Load from and save objects to files
  160.               * Possibly, hidden surfaces and shading
  161.  
  162.        Hopefully, I can have most of this done in a few months.
  163.  
  164.  
  165.        HAVE FUN :)
  166.  
  167.        Matt R. Johnson
  168.        151 Sunnyslope Bldg. 318 #22
  169.        Morris MN  56267
  170.  
  171.        johnson@scs.mrs.umn.edu
  172.        johnsomr@cda.mrs.umn.edu
  173.  
  174.